
If this is Tuesday, run the 

By Van Wolverton 

D espite wall calendars, pocket secretaries, and 
to-do lists, we still manage to forget appoint¬ 
ments, anniversaries, tax deadlines, and other 
important dates. Calendar programs let you enter all 
sorts of important dates and schedules, but you may 
not need to spend the money for them. DOS—with a 
little bit of help—lets you create simple reminders. 

Inside your computer is a battery-operated clock and 
calendar DOS uses to check the time and date each time 
you start or restart the system. This feature lets DOS 
keep track of the time and date a file was created or last 
changed. DOS doesn't let you do anything with the time 
and date, however, except display them or change them. 

One of the programs included with DOS does let you do 
more with the time and date: QBASIC.EXE runs pro¬ 
grams written in the BASIC language. 

DOS and BASIC are long-time partners 

DOS has given you the capability to write programs 
in some form of the BASIC language since Version 1. 

Since Version 5, this program has been called QBASIC 
to mark its similarity to a more advanced Microsoft 
product called QuickBasic. In earlier DOS versions, 
the program was called GWBASIC (IBM versions 
called it BASIC A or simply BASIC). 

You don't need to know how to write a BASIC pro¬ 
gram to use this technique, and this article won't try 
to show you how. We'll simply show you how to use 
the DOS COPY command to create a short QBASIC 
program that runs a program on a specific day. All 
you need to run a program on a particular date is a 
two-line QBASIC program that uses these elements: 

• DATE$—a QBASIC variable that contains the 
date kept by DOS 

• IF—a QBASIC statement that compares two 
values and executes another command if the 
comparison is true; one of the values it checks 
can be DATES 

• SHELL—a QBASIC command that runs any 
DOS command (including a program or a 
batch file) as if you had typed it 


Belgian program 


• SYSTEM—a QBASIC statement that ends the 
QBASIC program and returns control to DOS 

The QBASIC IF statement works much like the 
DOS IF command we use in batch files. The first part 
I specifies a comparison to be checked to see if it is true; 
j the second part specifies the QBASIC statements to be 
i executed if the comparison is true. The following IF 
1 statement, for example, compares the current date 
(DATES) to ”03-27-1994”: 

if dates = "03-27-1994" then shell "anniv" 

j If the comparison is true, then QBASIC tells DOS to 
: carry out the command enclosed in quotation marks: 

; SHELL "ANNIV” (notice that the structure of this sen- 
; tence describing what happens follows the same IF- 
: THEN structure as the QBASIC IF statement). The 
I SHELL statement sends whatever is between the quo- 
i tation marks to DOS as a command; the effect is the 
same as if you typed what's between the quotation 
I marks at the DOS command prompt. 

Creating a QBASIC program 
with COPY 

QBASIC includes a specialized text editor plus a set 
; of commands and function keys for writing, running. 
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and debugging programs. It isn't necessary to use 
QBASIC to write a program, however, because a pro¬ 
gram is simply a file that contains the program state¬ 
ments. You can create the program using any text 
editor that stores straight ASCII text or, for short pro¬ 
grams, simply by using the DOS COPY command to 
copy the console (input entered through the keyboard 
and echoed to the screen) to a file. 

We aren't learning QBASIC here, so we'll use the 
latter technique because it's quicker. Type the follow¬ 
ing to create a file named AUTO.BAS: 

C:\>copy con auto.bas 

if dates = "03-27-1994" then shell "anniv" 
system 

<F6><[Enter]> 

This QBASIC program runs the batch file ANNIV.BAT 
if the date is the same as the one specified in quotation 
marks. The last line, <F6><[Enterl>, means to press 
the function key labeled <F6>, then [Enter], to end the 
COPY command. Pressing <F6> will display in 
your file. 

The example shows the date as March 27,1994. 
When you type the if date$ line, substitute today's date 
for ”03-27-1994'', always including a 0 if necessary so 
that both the day and month are two digits long. If 


you don't include a zero before a single-digit day or 
month, the comparison will never be true because 
QBASIC always includes the leading zero. Notice also 
that the year contains four digits, not just the last two. 

The first line of the program is the IF statement that 
compares the current date to the date on which the 
program is to run and, if the dates are the same, runs 
the program using the SHELL command. The second 
line is a SYSTEM command that ends QBASIC and 
returns control to DOS. 

A batch file for testing 

You can run any program you like using this tech¬ 
nique. As a quick test, use the DOS COPY command 
again, this time to create the batch file below, named 
ANNIV.BAT. This batch file displays an important 
message, so we add a beep to it to draw attention. 
makes the system beep. You create the at the end 
of the fourth line by pressing [CtrljG. 

C:\>copy con anniv.bat 

@echo off 
echo. 

echo ANNIVERSARY IS ONE WEEK AWAY, 
echo GET PRESENT SOON! "G 
echo. 

<F6><[ Enter ]> 
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Now, run the QBASIC program to see if it will run 
ANN1V.BAT. The command to nm QBASIC is simply 
QBASIC. You must add the /RUN parameter, which 
tells QBASIC not to start its editor, but to run the pro¬ 
gram whose name follows /RUN, then return control to 
DOS. QBASIC assumes the file extension of the program 
is BAS, so you must type only the filename (AUTO): 

qbasic /run auto 

NOTE: In Version 4 or an earlier version of DOS, the 
name of the BASIC language interpreter is different. 

It's GWBASIC if you're using MS-DOS from Microsoft 
and BASICA if you're using PC-DOS from IBM. Re¬ 
place the QBASIC command in the example with 
GWBASIC AUTO if you're using MS-DOS or BASICA 
AUTO if you're using PC-DOS (you don't need the 
/RUN parameter with either GWBASIC or BASICA). 

If you specified today's date in the IF statement, 
AUTO.BAS should run the batch file ANNIV.BAT, 
which beeps and displays the cautionary message 
about an upcoming anniversary. 

If the program fails to perform as it should, use the 
TYPE command to compare the contents of AUTO.BAS 
and ANNIV.BAT with the earlier instructions. Pay par¬ 
ticular attention to the date specified in the IF state¬ 
ment in AUTO.BAS: The day and month must be two 
digits long, using a 0 before a single-digit day or month 
number. If you find any errors, either edit the files with 
the DOS Editor or use the COPY command again as 
described in the earlier instructions. Make sure that the 
date specified in the IF statement matches the date you 
see when you type the DATE command. 

If ANNIV.BAT does run as it should, test again to 
make sure that ANNIV.BAT doesn't run on a different 
date. Type the following to change the date to January 
1,1999, and test the program again: 

C:\>date 1/1/99 
C:\>qbasic /run auto 

The message shouldn't display this time because 
AUTO.BAS shouldn't run ANNIV.BAT with the 


faulty date. If the message is displayed, check the con¬ 
tents of AUTO.BAS and ANNIV.BAT against the in¬ 
structions again and correct any differences. 

When the program is working properly, use the 
DATE command to restore today's date. To safeguard 
yourself against forgetting your anniversary, change 
the date in AUTO.BAS to your anniversary and put the 
QBASIC /RUN AUTO command in AUTOEXEC.BAT. 

Running your own programs 

To run any program on any date, substitute the date on 
which you want to run the program for ”03-27-1994” in 
the IF statement of the QBASIC program, and substitute 
the command that runs the program for ANNIV. Re¬ 
member to include a 0 before the month or day if it's 
a single-digit number and to use all four digits of the 
year. Put the QBASIC command in AUTOEXEC.BAT. 

If you want to run several programs on different days 
(or on the same day), just put an additional IF statement 
in AUTO.BAS for each program you want to run, speci¬ 
fying the date and command that runs the program. The 
following QBASIC program, for example, would run a 
program named ANNTV on March 27,1994, and pro¬ 
grams named ACCOUNT and DIALUP on May 5,1994: 

if dates = "03-27-1994" then shell "anniv" 

if dates = "05-05-1994" then shell "account" 

if dates = "05-05-1994" then shell "dialup" 

system 

Put these commands in AUTOEXEC.BAT and 
they'll run the specified programs each time you start 
or restart your system on the specified dates. This 
method isn't as handy as the automatic program ex¬ 
ecution capabilities some programs offer, but you 
don't have to buy another program to get this capabil¬ 
ity. You're letting DOS do it for you. M 

Contributing editor Van Wolverton is the author of the 
best-selling books Running MS-DOS and Supercharging 
MS-DOS. Van, who has worked for IBM and Intel, lives in 
Alberton, Montana. 


WORKING SMARTER 

I 5.0 & 6.x 

Setting default switches for the DIR command 


he DOS DIR command lets you display direc¬ 
tory information in many different ways. You 
can sort your files and subdirectories by various 
criteria, and you can select the format and type of in¬ 
formation to display. Unfortunately, you must use a 
complex series of command switches to tell DOS how 
to execute the DIR command. 


If you usually use the same switches when you ex¬ 
ecute the DIR command, you can save yourself a lot 
of keystrokes by setting the DIRCMD environment 
variable. In this article, we'll show you how to use 
DIRCMD in your AUTOEXEC.BAT to create a set of 
default switches for the DIR command. Then we'll 
override those default switches at the command line. 
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How DIRCMD works 

DIRCMD is a DOS environment variable that controls 
the operation of the DIR command. Environment vari¬ 
ables are containers that store information during the 
current DOS session. Consequently, when you use the 
DIRCMD variable to assign switches to the DIR com¬ 
mand, those switches remain in effect until you reboot 
your computer. 

You establish the DIRCMD variable's value by issu¬ 
ing the SET command. You use the syntax 

set dircmd=/si//fc/? 

After you set DIRCMD, the DIR command will ex¬ 
ecute those switches each time you type 

dir 

from the command prompt. 

Since environment variables exist only during a 
single DOS session, you must reset the DIRCMD en¬ 
vironment variable every time you reboot your com¬ 
puter. To do so, you simply set DIRCMD's value in 
your AUTOEXEC.BAT file. By doing so, you reestab¬ 
lish the default switches every time you boot your 
computer. Now, let's modify the AUTOEXEC.BAT 
file to take advantage of DIRCMD. 

Changing AUTOEXEC.BAT 

For our example, we'll establish default switches that 
automatically sort our directory listings alphabetically 
and pause when a listing occupies more than one 


screen. Since the AUTOEXEC.BAT file normally exists 
in the root directory, type 

C:\>edit c:\autoexec.bat 

to open the AUTOEXEC.BAT file in the DOS Editor. 
Now, type 

set dircmd=/o /p 

on its own line of the AUTOEXEC.BAT file. Save the 
file and close the Editor. Now, you just need to reboot 
your computer to change the default DIR settings. 

Testing the new settings 

Before we reboot our computer, let's observe the DIR 
command's current behavior. To do so, simply type 

C: \>di r 

and press [Enter]. As Figure A shows, DOS displays 
the directory listing of our root directory. Since we 
haven't taken the time to clean out our root directory 
recently, the directory requires more than one screen. 
The files appear in the order in which we added them 
to the directory. 

To establish the default DIR switches, hold down 
the [Ctrl], [Alt], and [Del] keys to reboot your com¬ 
puter. When the AUTOEXEC.BAT file executes, it pro¬ 
cesses the SET DIRCMD command. To demonstrate 
the default switches, again type 

C: \>di r 


Don't fall asleep at the switch 

T A each successive version of DOS, the DIR 

V V command has gained more switches. You can 
now customize the DIR command to present your di- 

DIR command switches 

rectory listings in an almost limitless number of combi¬ 
nations. To help you keep track of the DIR command's 
switches, we put together this quick reference table. 

General switches 

/os 

Sorts by size, smallest first 

/B Bare format (No heading or summary) 

/o-s 

Sorts by size, largest first 

/L Filenames in lowercase 

/OD 

Sorts by date, oldest first 

/S Displays files in all included subdirectories 

/O-D 

Sorts by date, newest first 

/P Pauses after each screen 

/OG 

Default order, directories first 

/W Displays in wide format 

/O-G 

Default order, files before directories 

Sort switches 

Attribute switches 

/O Sorts by name, directories first 

/AD 

Subdirectories only 

/ ON Sorts by name, directories intermixed 

/AH 

Hidden files only 

/ O-N Reverse sorts by name, directories intermixed 

/AS 

System files only 

/ OE Sorts by extension 

/AR 

Read-only files only 

/O-E Reverse sorts by extension 

/AA 

Archive files only 
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from the command prompt. As Figure B shows, this 
time our computer lists the files in alphabetical order, 
directories first. It also pauses at the bottom of the 
first screen of entries. 

As you can see, the DIRCMD environment variable 
can make the DIR command more useful. Now, let's 
look at how you can control the DIR command after 
you've established the default switches. 

Figure A 


fault switches you established with DIRCMD. Fortu¬ 
nately, it's easy to modify the DIR command, even if 
you've established new settings with DIRCMD. 

If you attach another switch, such as /W, to the 
DIR command, DIR executes as if you'd entered that 
switch along with all the switches you established 
with DIRCMD. 

For example, we set up the /O and /P switches in 
the DIRCMD environment variable. If we issue the 
command 


Uolune in drive C is DOS 5 
Uolume Serial Number is 1A9D-81D8 
Directory of C:S 


BCOPV 

BAT 

1564 

10-26-93 

7:05p 

DOS 


<D1R> 


04-29-93 

4:04p 

COLLUIN 


<D1R> 


08-06-93 

11:37a 

U1NA20 

386 

9349 

04-09-91 

5:00a 

SVS 


<DIR> 


11-01-93 

3:02p 

CONFIG 

SVS 


218 

01-09-94 

9:24a 

WINDOWS 


<D1R> 


04-29-93 

4:29p 

TSR 

BAT 


70 

01-04-94 

3:24a 

TSRl 

BAT 


144 

01-04-94 

3:20a 

TXT 


<D1R> 


11-01-93 

8:55p 

FIGS 


<D1R> 


04-30-93 

2:23p 

GNKW 


<D1R> 


09-13-93 

4:42a 

PSFONTS 


<D1R> 


09-13-93 

4:42a 

WPG 


<D1R> 


09-13-93 

4:43a 

SIZE 

BAT 


98 

01-05-94 

6:25a 

HOUSE 


<DIR> 


05-18-93 

9:52a 

BATCH 


<D1R> 


05-27-93 

10:08a 

HIRROR 

BAK 

90112 

06-10-93 

11:08a 

MIRROR 

FIL 

90112 

06-18-93 

3:l0p 

WPWIN 


<D1R> 


09-13-93 

4:44a 

COLLDOS 


<D1R> 


08-06-93 

12:25p 

PKUNZIP 


<D1R> 


09-24-93 

l:48a 

BUTTONS 


<DIR> 


09-27-93 

i:45a 

AUTOEXEC 

BAT 


240 

01-04-94 

3:21a 


24 file(s) 191907 bytes 

35917824 bytes free 


This directory iisting 
appears in the order the 
fiies are stored on disk 
and requires more than 


c:s> 


one screen. 


Figure B 


Uolume in drive C is DOS 5 
Uolume Serial Number is 1A9D-81D8 
Directory of C:S 


BATCH 


<DIR> 

05-27-93 

10:08a 

BUTTONS 


<DIR> 

09-27-93 

l:45a 

COLLDOS 


<DIR> 

08-06-93 

12:25p 

COLLWIN 


<DIR> 

08-06-93 

11:37a 

DOS 


<DIR> 

04-29-93 

4:04p 

FIGS 


<DIR> 

04-30-93 

2:23p 

GNKW 


<DIR> 

09-13-93 

4:42a 

MOUSE 


<DIR> 

05-18-93 

9:52a 

PKUNZIP 


<DIR> 

09-24-93 

l:48a 

PSFONTS 


<DIR> 

09-13-93 

4:42a 

SVS 


<DIR> 

11-01-93 

3:02p 

TXT 


<DIR> 

11-01-93 

8:55p 

WINDOWS 


<DIR> 

04-29-93 

4:29p 

WPC 


<DIR> 

09-13-93 

4:43a 

WPWIN 


<DIR> 

09-13-93 

4:44a 

AUTOEXEC 

BAT 

240 

01-04-94 

3:21a 

BCOPV 

BAT 

1564 

10-26-93 

7:05p 

CONFIG 

SVS 

218 

01-09-94 

9:24a 

MIRROR 

BAK 

90112 

06-10-93 

11:08a 

Press any key to continue . . . 

(continuing C:S) 


MIRROR 

FIL 

90112 

06-18-93 

3:l0p 

SIZE 

BAT 

98 

01-05-94 

6:25a 

TSR 

BAT 

70 

01-04-94 

3:24a 

TSRl 

BAT 

144 

01-04-94 

3:20a 

WINA20 

386 

9349 

04-09-91 

5:00a 


24 file(s) 191907 bytes 

35919872 bytes free 


After you set the DiRCMD 
environment variabie, the 
DiR command uses the 


c:s> 


switches you estabiished. 


Overriding DIRCMD 

Even if you use DIRCMD to establish default switches 
for the DIR command, you may still occasionally need 
to attach other switches to the DIR command. For ex¬ 
ample, you may want to display the file information in 
the wide format by attaching the / W switch to the DIR 
command. You may also need to cancel one of the de- 


C:\WINDOWSxlir /w 


in our WINDOWS subdirectory, DOS displays the di- 
^ rectory listing shown in Figure C. As you can see, the 
; listing appears in alphabetical order and pauses after a 
= screenful of entries. However, it also acknowledges 
! the /W switch and displays the listing in wide format. 

To cancel a default switch's effect, you simply attach 
i that switch to the DIR command, but you place a minus 
sign (-) in front of the switch. For example, to cancel the 
j /P switch that you saved in DIRCMD, you type 

; C:\WINDOWSxlir /-p 

; and press [Enter]. Figure D on page 6 shows the be- 
^ ginning and the end of the directory DOS displays. 

• This time the listing appears in alphabetical order, but 
^ it doesn't pause at the end of each screen of entries. 


Figure C 


5 Uolume in drive C is DOS 5 

Uolume Serial Number is 1A9D-81D8 
3 Directory of CAUINDOWS 


i [.] 

[. .] 

[SYSTEM] 

256C0L0R.BMP 

ACCESSOR.GRP 

■ APPLICAT.GRP 

APPS.HLP 

ARCADE.BMP 

ARCHES.BMP 

ARGVLE.BMP 

' ATM.INI 

ATMCNTRL.EXE 

BOOTLOG.TXT 

CALC.EXE 

CALC.HLP 

i CALENDAR.EXE 

CALENDAR.HLP 

CANYON.MID 

CARDFILE.EXE 

CARDFILE.HLP 

; CARS.BMP 

CASTLE.BMP 

CHARMAP.EXE 

CHARMAP.HLP 

CHIMES.WAU 

i CHITZ.BMP 

CHORD.UAU 

CLIPBRD.EXE 

CLIPBRD.HLP 

CLOCK.EXE 

i CLOCK.INI 

COLLAGE.INI 

COLLAGEC.GRP 

CONTROL.EXE 

CONTROL.HLP 

! CONTROL.INI 

DING.UAU 

DOSAPP.INI 

DOSPRMPT.PIF 

DRWATSON.EXE 

i EDIT.PIF 

EGVPT.BMP 

EMM386.EXE 

EXPAHD.EXE 

FLOCK.BMP 

i GAMES.GRP 

GLOSSARY.HLP 

GRAMMATI.GRP 

HIMEM.SYS 

HONEV.BMP 

! HPPCL.X02 

LEAUES.BMP 

MAIN.GRP 

MARBLE.BMP 

MORICONS.DLL 

MOUSE.INI 

MPLAVER.EXE 

MPLAVER.HLP 

MSD.EXE 

MSD.INI 

! NETWORKS.URI 

NOTEPAD.EXE 

NOTEPAD.HLP 

PACKAGER.EXE 

PACKAGER.HLP 

PBRUSH.DLL 

PBRUSH.EXE 

PBRUSH.HLP 

PIFEDIT.EXE 

PIPEDIT.HLP 

; PRINTERS.WRI 

PRINTMAN.EXE 

PRINTMAN.HLP 

PROGMAN.EXE 

PROGMAN.HLP 

PROGMAN.INI 

QBASIC.PIF 

RAMDRIUE.SVS 

README.WRI 

RECORDER.DLL 

; RECORDER.EXE 

RECORDER.HLP 

REDBRICK.BMP 

REG.DAT 

REGEDIT.EXE 

i REGEDIT.HLP 

REGEDITU.HLP 

RIUETS.BMP 

SCRNSAUE.SCR 

SETUP.EXE 

i SETUP.HLP 

SETUP.TXT 

SMARTDRU.EXE 

SMQUOTE.INI 

SOL.EXE 

Press any key to continue . 




: (continuing C:SWINDOWS) 




] SOL.HLP 

SOUNDREC.EXE 

SOUNDREC.HLP 

SQUARES.BMP 

SSFLYWIN.SCR 

1 SSMARQUE.SCR 

SSMYST.SCR 

SSPCWEEK.SCR 

SSSTARS.SCR 

STANDARD.WPT 

i STARTUP.GRP 

SVSINI.URI 

SYSTEM.BAK 

SYSTEM.INI 

TADA.WAU 

1 TARTAN.BMP 

TASKMAN.EXE 

TERMINAL.EXE 

TERMINAL.HLP 

THATCH.BMP 

WIN.BAK 

WIN.COM 

WIN.INI 

WIN.OLD 

WINFILE.EXE 

• WINFILE.HLP 

WINFILE.INI 

WINHELP.EXE 

WINHELP. HLP 

WININI.WRI 

WINLOGO.BMP 

WINMINE.EXE 

WINMINE.HLP 

WINMINE.INI 

WINTUTOR.DAT 

j WINTUTOR.EXE 

WINUER.EXE 

WORDPERF.GRP 

WPC.INI 

WPCSET.BIF 

WPFM.INI 

UPKICK.INI 

WPSP.INI 

WPTH.INI 

WPWIN.REG 

WPWP.INI 

WPtWPlUS.SUP 

WP100001.TMP 

WRITE.EXE 

WRITE.HLP 

WTAPI.INI 

ZIGZAG.BMP 

_DEFAULT.PIF 

~MF3060.TMP 

~WP2318.TMP 

150 fi: 

le(s) 5008152 

bytes 




35919872 bytes free 




i C:SU1ND0US> 

\ _ 


i If you attach another switch, such as AN, to the DIR command, 
I DOS executes that switch plus the other switches established 
i in DIRCMD. 
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Figure D 

Uolune i 

in dr 

iue C is DOS 5 


Uolune Seria 

1 Nunber is 1A9D-81D8 

Directory of 

CAUINDOUS 




<DIR> 

04-29-93 

4:29p 



<DIR> 

04-29-93 

4:29p 

SVSTEM 


<DIR> 

04-29-93 

4:29p 

256C0L0R 

BMP 

5078 

03-10-92 

3:10a 

ACCESSOR 

GRP 

9447 

01-13-94 

7:02a 

APPLICAT 

GRP 

2252 

01-13-94 

7:02a 

APPS 

HLP 

15694 

03-10-92 

3:10a 

ARCADE 

BMP 

630 

03-10-92 

3:10a 

ARCHES 

BMP 

10358 

03-10-92 

3:10a 

ARGVLE 

BMP 

630 

03-10-92 

3:10a 

ATM 

INI 

1099 

05-03-93 

10:46a 

ATMCNTRL 

EXE 

115904 

10-28-92 

2:50a 

BOOTLOG 

TXT 

1181 

04-29-93 

4:32p 

UPUP 

INI 

2896 

01-09-94 

9:15a 

WP{UP>US 

SUP 

330 

09-13-93 

l:40a 

UP}00001 

TMP 

0 

09-09-93 

10:56p 

URITE 

EXE 

244976 

03-10-92 

3:10a 

URITE 

HLP 

36971 

03-10-92 

3:10a 

WTAPI 

INI 

888 

09-07-93 

li:42p 

ZIGZAG 

BMP 

630 

03-10-92 

3:10a 

DEFAULT 

PIF 

545 

04-29-93 

4:39p 

"'MF3060 

TMP 

18 

08-31-93 

10:57p 

~UP2318 

TMP 

0 

09-09-93 

10:56p 

150 file(s) 5008152 bytes 



35911680 bytes free 


C:SUINDOUS> 


If you attach the 
switch /-P to the 
DIR command, 
you cancel the /P 
switch stored in 
DIRCMD. 


Finally, if you want to issue a switch that conflicts 
with a switch you established with DIRCMD, simply 
attach that switch to the DIR command. For example, 
if you want to use the /OF switch to sort your files by 
extension instead of accepting the /O switch you es¬ 
tablished with DIRCMD, simply type 

C:\WINDOWS>dir /oe 

and press [Enter]. As Figure E shows, DOS lists the files 
in alphabetical order by extension. However, even 
though the /OE switch overrides the /O switch, DIR 
still recognizes the /P switch you stored in DIRCMD. 


Figure E 


Uolune in drive C is DOS 5 
Uolune Serial Nunber is 1A9D-81D8 
Directory of CrSUINDOUS 




<DIR> 

04-29-93 

4:29p 



<DIR> 

04-29-93 

4:29p 

SVSTEM 


<DIR> 

04-29-93 

4:29p 

SVSTEM 

BAK 

1595 

04-29-93 

4:44p 

UIN 

BAK 

3467 

05-03-93 

10:43a 

UPCSET 

BIF 

20065 

09-13-93 

4:15a 

ARGVLE 

BMP 

630 

03-10-92 

3:10a 

CARS 

BNP 

630 

03-10-92 

3:10a 

FLOCK 

BMP 

1630 

04-30-93 

9:12a 

REDBRICK 

BMP 

630 

03-10-92 

3:10a 

ZIGZAG 

BMP 

630 

03-10-92 

3:10a 

256C0L0R 

BMP 

5078 

03-10-92 

3:10a 

ARCHES 

BMP 

10358 

03-10-92 

3:10a 

HONEV 

BMP 

854 

03-10-92 

3:10a 

MARBLE 

BMP 

27646 

03-10-92 

3:10a 

RIUETS 

BMP 

630 

03-10-92 

3:10a 

TARTAN 

BMP 

32886 

03-10-92 

3:10a 

THATCH 

BMP 

598 

03-10-92 

3:10a 

U INLOGO 

BMP 

38518 

03-10-92 

3:10a 


Press any key to continue . . . 


(continuing CAUINDOUS) 


PRINTERS 

URI 

44928 

03-10-92 

3:10a 

README 

URI 

99584 

03-10-92 

3:10a 

SVSINI 

URI 

53760 

03-10-92 

3:10a 

UININI 

URI 

31104 

03-10-92 

3:10a 

HPPCL 

X02 

659 

01-09-94 

9:15a 


150 file(s) 5008152 bytes 

35919872 bytes free 


C:SUINDOUS> 


If you attach a switch 
that conflicts with 
a switch you estab¬ 
lished using • 
DIRCMD, DOS 
recognizes the 
switch you enter at 
the command line. 


Learning the switches 

The DIR command offers a number of useful switches. 
For a handy reference table to the DIR switches, see 
"Don't Fall Asleep at the Switch" on page 4. 


Conclusion 

If you prefer to display your directory listings in a 
format other than the DOS default, you probably use 
some of DIR's switches. You can establish default 
switches for DIR by setting the DIRCMD environ¬ 
ment variable in your AUTOEXEC.BAT file. In this 
article, we showed you how to set default DIR 
switches with DIRCMD. 1 


Safeguarding batch files when 

W hen you redefine your DIR command by using 
the SET DIRCMD directive, the new definition 
of DIR resides in memory unless you change it. If you 
set DIRCMD at the DOS prompt, you can disable it by 
rebooting your computer or by turning it off on the com¬ 
mand line. If the directive is in your AUTOEXEC.BAT or 
CONFIG.SYS file, you must remove it, or you can dis¬ 
able it at the DOS prompt. You can turn off DIRCMD's 
definition at the DOS prompt by issuing the command 

SET DIRCMDr 

When you redefine your DIR command using the 
DIRCMD environment variable, you must remember 
that the new definition of DIR overrides the default 
DIR command in your batch files, too. You may dis¬ 
cover that your batch file seemingly takes forever to 
finish its task; or, your batch file might crash alto¬ 
gether and not let you know. 


you set DIRCMD 

You can restore the default definition of DIR by add¬ 
ing four commands to any batch file that contains a DIR 
command. The first command temporarily stores your 
DIRCMD definition in a variable. (Of course, you can 
use any name for storing your temporary DIRCMD 
definition.) The second restores the DIR command to its 
default definition. Add to your batch file the following 
two lines before the line that runs the DIR command: 

SET TMPDIR=%DIRCMD% 

SET DIRCMDr 

The third command restores your DIRCMD definition, 
and the fourth erases your temporary variable. Add 
these lines after the line that runs the DIR command 
and before the end of the batch file: 

SET DIRCMD=%TMPDIR% 

SET TMPDIR= 
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BATCH FILE & MACRO 


Finding the size of your directories 


Kzimiami 

5.0 & 6.x 


D O you ever need to know how many files are j 
I in a directory or how much space those files i 
consume? For example, you might want to use j 
XCOPY to copy a group of files to a floppy disk but fit j 
the files on as few disks as possible. j 

DOS provides a couple of ways to find the informa- j 
tion you need. You can view the last lines of the out- 1 
put of a DIR command, or you can find the informa¬ 
tion you need by using the DOS Shell. If you want j 
information on one or two directories, either of these j 
methods might be okay. However, if you want inf or- | 

mation about several directories, repeating the steps 
in either method gets old in a hurry. 

Instead, you need a way to get the information you 
want with a single command. This article will provide 
you with two methods you can use. First, weTl show | 
you a batch file you can use to find the total size and 
number of files in any directory and its subdirectories 
on any drive. Then weTl show you a Doskey macro 
that will give you the same information but doesn't 
trap for errors. ; 

An overview i 

Both the batch file and the macro use multiple FIND i 
commands as well as information that's readily avail- | 
able to you through the DIR/S command. You use the 
/S switch to list all the files in a specified directory, 
including the files that occupy subdirectories. For ex¬ 
ample, running a DIR/S command on our C:\GU 
directory produced the listing shown in Figure A. 

Figure A 


Volume 

in drive C 

is H0ST_F0R_C 


Volume Serial Number is 16D9-1668 

Directory of C:SGU 



<DIR> 

01-13-94 

6:21a 


<DIR> 

01-13-94 

6:21a 

COLLAGE 

<DIR> 

01-13-94 

6:22a 

TENP 

<DIR> 

01-13-94 

6:22a 

GUFILE 


1,106 01-13-94 

6:26a 


5 file(s) 

1,106 bytes 

Directory of C:SGUSCOLLAGE 



<DIR> 

01-13-94 

6:22a 


<DIR> 

01-13-94 

6:22a 

SHOU 

EXE 

34,317 06-19-91 

9:52a 

SNAP 

EXE 

42,416 10-29-91 

4:35p 

SAVE 

EXE 

27,060 10-29-91 

4:37p 

VIEU 

EXE 

35,018 10-29-91 

4:38p 

S 

EXE 

6,070 06-08-91 

8:46p 


7 file(s) 

144,881 bytes 

Directory of C:SGU\TENP 



<DIR> 

01-13-94 

6:22a 


<DIR> 

01-13-94 

6:22a 

VLIST-A 

TIF 

112,190 06-30-93 

5:i8p 

VLIST-B 

TIF 

112,190 07-01-93 

10:47a 


4 filets) 224,380 bytes 


As you can see, this listing gives us the answer 
we're looking for, but it provides more information 
than we really need. Also, the file count includes the 
directories, which we don't want. We eliminate the 
extra information using DIR's /A:-D switch and a 
group of FIND commands. You can read more about 
the FIND command in "Powering Up the FIND Com¬ 
mand" on page 9. 

The key to the technique is using the pipe operator 
(I) to stack the commands. The pipe operator sends 
the output of each part of the command through the 
command to its right, manipulating and focusing the 
information as it proceeds. We use the pipe operator 
to filter out the information we don't want. 

Now let's combine the commands we just looked at 
into a batch file that will determine the amount of disk 
space consumed by the files in a specified directory 
and all its subdirectories. Later, we'll show you how 
the basic technique works as a Doskey macro. 

The SIZE batch file 

Use Edit or another compatible word processor to en¬ 
ter the batch file shown in Figure B, and save it under 
the name SIZE.BAT in your batch file directory or an¬ 
other directory listed in your PATH statement. (Note 
that there is a space character between the quotation 
marks in the last FIND statement.) 

Figure B 


Qecho off 

rem SIZE.BAT displays the size and nunber of files in a 
ren specified directory and its subdirectories. 

if "xl”=="N" goto :C0HPILE 
if not exist xlSnul goto :0NERR0R 

:C0MPILE 

echo Compiling information for xl directory 

dir Xl /s/’a:-d! find/w find/w '’Volume"! find/u "bytes free"! find " "!more 

goto :END 

rONERROR 
els 
echo. 

echo === Check your syntax. You must include the 
echo === complete path to a valid directory, 
echo === Do not include spaces in the path name, 
echo. 

echo ==Examples== 

echo C:S)size uindous ==Next level 

echo C:SUINDOUS)size S ==Size of root directory 

echo CAGANESlsize Suindous ==S^u<le level, different path 

echo C:STEHP)size b: ==Different drive 

echo. 

:END 

C:S> 


SIZE.BAT will show you the number of files in and the size of 
directories and their subdirectories. 


Total files listed: 

16 file(s) 370,367 bytes 

132,300,800 bytes free 

C:SGU> 


DiR/S shows ail the files in the directory and its subdirectories. 


How SIZE.BAT works 

Now you're ready to use SIZE.BAT. Before we test the 
batch file, let's take a look at how it works. Like most 
batch files, SIZE.BAT begins with ©ECHO OFF and 
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REM statements. Then the batch file determines which 
subroutine to invoke. The first IF statement 

if goto iCOMPILE 

tests whether you entered a backslash after the SIZE 
command to specify the root directory. If you entered 
a backslash, the iCOMPILE routine begins. If you 
didn't enter a backslash, the batch file traps for errors 
with the second IF statement. 

The second IF statement 

if not exist %1\nul goto :0NERR0R 

checks whether you passed a valid directory as the 
parameter. This command's syntax is interesting be¬ 
cause, as you may know, you can't directly check for 
the existence of a directory in DOS. In this statement, 
nul acts as a dummy filename. We must use the syntax 
%l\nul to check for the existence of files in the speci¬ 
fied directory. If the statement finds files in the direc¬ 
tory, it means there must be a directory. 

If the second IF statement doesn't find the directory 
you specified, the batch file displays the message in 
the rONERROR routine and then ends. If the IF state¬ 
ment finds the directory you specified, the iCOMPILE 
routine begins. If you have lots of directories or files in 
your directory, it might take DOS several seconds to 
compile the information. 

The second line of the iCOMPILE routine is the 
heart of the batch file. The first part, dir %1 Is, gener¬ 
ates a list of files in the specified directory and all its 
subdirectories. Next, the la:-d switch removes all the 
subdirectories from the display, including the . and .. 
directories. If this command finds a directory that con¬ 
tains only subdirectories—no actual files—it removes 
that directory from the display. It also removes the 
subdirectories from the file count, leaving you with an 
accurate count of the files in the directory. 

Next, the find /v statement searches for the hy¬ 

phen character and displays any line that doesn't 
contain a hyphen. This command eliminates the file¬ 
names, since each line that lists a filename also lists 
the file's date, which includes hyphens. Note, how¬ 
ever, that this command also eliminates any directory 
whose name includes a hyphen. 

The next three FIND commands are optional and 
fine-tune the display. The find /v "Volume" command 
eliminates the line at the beginning of the display that 
contains the disk label. The command find /v "bytes free" 
takes away the last line of the directory display contain¬ 
ing the amount of remaining free space. The find 
command winnows out the blank lines by searching for 
and displaying lines that contain a space character. 


Finally, more creates a temporary file of the infor¬ 
mation and displays that information one screenful at 
a time. Now that we know how the batch file works, 
let's use it. 

Using SIZE.BAT 

Using SIZE.BAT is easy. You simply enter the command 
size 

followed by the name of the directory, drive, or direc¬ 
tory on a drive you want information about. If the di¬ 
rectory you want to check isn't on your current path, 
you'll need to provide the appropriate path. 

Let's return to our earlier example. To see a listing 
for the C:\GU directory from the root directory of 
drive C, just enter the command 

C:\>size gu 

Figure C shows the SIZE.BAT listing. 

Figure C 

C:S>size gu 

Compiling information for gu directory 

Directory of C:SGUNCOLLAGE 

5 file(s) 144,881 bytes 

Directory of CAGUSTEMP 

2 file(s) 224,380 bytes 

Total files listed: 

7 file(s) 369,261 bytes 

C:S> 


SIZE.BAT summarizes the file and size information for the directory 
you specified and for the directories down that path. 

You'll notice that the parent directory, C:\GU, does 
not appear in the listing. As we mentioned, SIZE.BAT 
won't list any directory that doesn't contain actual 
files. Since C:\GU contains only directories, it doesn't 
appear in the listing. 

You can generate the listing in Figure C from the 
C:\GU\TEMP directory. Simply enter the command 

C:\GU\TEMP>size \gu 

From drive B, use the command 

B:\>size c:\gu 

to see the listing. From inside a directory on a disk in 
the B drive, we change to the B:\BACKOFF directory 
and enter the command 

B:\BACKOFF>size c:\gu 

You can create a shorter version of the batch file as 
a Doskey macro. (We'll discuss the pros and cons of 
using a batch file or a macro in a future article.) Our 
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macro will list the same information as the batch file 
but won't verify that you passed it a valid directory as 
a parameter. Although it doesn't give you the safety 
net the batch file does, it may be all you need. Let's 
create the DSIZE Doskey macro now. 

The DSIZE Doskey macro 

We'll call our macro DSIZE to distinguish it from our 
batch file. We'll create the macro in the AUTOEXEC.BAT 
file so it will load into memory each time we boot up. 

The command we'll use in our DSIZE macro is es¬ 
sentially the same as the dir statement we use in the 
COMPILE routine in SIZE.BAT. The only differences 
are the addition of the DOSKEY command and the 
usage of the macro equivalents of batch file symbols 
for operators and parameters. 


Using Edit or another compatible word processor, 
open your AUTOEXEC.BAT file and add the follow¬ 
ing line anywhere in the file: 

doskey dsize=dir $1 Is /a:-d $b find /v $b find /v 
"Volume" $b find /v "bytes free" $b find " " $b more 

The entire command takes 107 spaces on a single line, 
well within the 127-character limit DOS imposes on 
macros and other commands entered from the com¬ 
mand line. (Note the space between the quotation 
marks in the last FIND command.) Now save your 
AUTOEXEC.BAT file and press [Ctrl][Alt][Del] to 
reboot your computer. 

After your computer reboots, you can easily use the 
DSIZE macro by entering the command followed by 


Powering up the FIND command 

Y ou can use the FIND command not only to search 
for text strings in files, but also to pinpoint infor¬ 
mation that can help you manage files and configure 
your system. By using FIND's switches, you have 
even more power at your fingertips. Let's see how 
you can get more out of FIND and its switches. 

You use FIND to search a file for a text string you 
specify. For example, you can display the line in your 
CONFIG.SYS file that contains the ANSI.SYS driver 
by entering the command 

find "ANSI.SYS" config.sys 

You can also use FIND as a filter when you search 
input from another command. This command 

mem /d I find "ANSI" 

looks in the output of a MEM/DEBUG command and 
tells you whether your ANSI.SYS file is loaded. (MEM 
/D tells you the location of each device driver and 
program currently in memory.) 

The default FIND commands are powerful. You 
can get even more out of FIND by using its switches: 

• /C tells FIND to Count the occurrences of the 
text string and display only the number of 
occurrences. 

• II tells FIND to Ignore case when it searches, 
and finds the text string in capital or lower¬ 
case letters, or any mix of the two. 



• IN tells FIND to display the line Number in the 
original file when it displays the line contain¬ 
ing the string. 

• /V tells FIND to re Verse its logic and display 
only the lines that don't contain the specified 
string. (We use the /V switch extensively in 
"Finding the Size of Your Directories" on 
page 7.) 

Now let's enhance some FIND commands. In our 
first example, we typed ANSI.SYS in uppercase. The 
FIND command is case sensitive. This is a good time 
to use the /I switch just in case you typed ansi.sys in 
lowercase in your CONFIG.SYS file: 

find /i "ansi .sys" config.sys 

To find the total number of directories on your sys¬ 
tem, use the /C switch in the command 

dir Is 1 find "<DIR>" /c 

You can't combine the /C and /N switches. If you 
do, the /C switch will prevail. However, you can enter 

find /i /n "device" config.sys 

to display the lines and the line numbers of your de¬ 
vice drivers, and then you can count how many device 
drivers you load from the CONFIG.SYS file. 
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the name of the directory you want to check: 
dsize directory 

For example, if you want to check the total space and 
number of files in the WINDOWS directory, enter this 
command: 

C:\>dsize windows 

When you do, DOS will display the macro followed 
by its output, as shown in Figure D. You'll notice that 
when DOS displays the macro, it shows the pipe op¬ 


erators (I) instead of the $b characters you used to 
represent the pipe operator. As you can see, this mac¬ 
ro is a quick and easy alternative to the SIZE.BAT 
batch file. X 


Figure D 


CA>dsize uindous 

C:S>dir uindous /s /a:-d I find /u 5 find /u "Volune" J find /u "bytes free" 

I find " " ! more 

Directory of CAUINDOUS 

133 file(s) 4,652,132 bytes 

Directory of CAUINDOUSSSVSTEM 

186 file(s) 5,933,378 bytes 

Total files listed: 

319 file(s) 10,585,510 bytes 

C:S> 


DOS displays the macro and its output when you invoke the macro. 


DOS 6 TIP 



Using FASTHELP to view short help messages 


ne of DOS 6's most impressive command en¬ 
hancements is the HELP utility. Instead of 
the bare-bones, single-screen ASCII HELP 
system in Version 5, now you have a comprehensive, 
multiscreen utility complete with color, scrolling and 
searching capabilities, and hypertext access to related 
topics. You invoke the HELP utility using a command 
in the form 

help command 

If you're trying to learn about DOS or about a spe¬ 
cific command, the DOS 6 HELP utility can be a life- 
saver. If you already know the basics but just want to 
review a command's syntax and switches, invoking the 
full HELP utility seems like overkill. Fortunately, the 
folks at Microsoft anticipated this need and included 
the FASTHELP command, which gives you the same 
kind of information as the DOS 5 HELP system. 

You invoke the FASTHELP command by entering 

fas the Ip command 

where command is the name of the command whose 
HELP you want to view. You can also use the /? 
switch to invoke FASTHELP in DOS 6, like this: 

command /? 

It's that simple. 

For example, to view the full HELP for the AP¬ 
PEND command, just enter 

C:\>help append 

and you'll see the HELP utility screen shown in Fig¬ 
ure A. To see abbreviated HELP for APPEND, enter 
the command 


C:\>fasthelp append 
or 

C:\>append /? 

DOS will display the short help shown in Figure B. X 


Figure A 




Help 1 

1 - 

NS-DOS Help: APPEND 



4Notes^ 4Exanples^ 


APPEND 

Enables programs to open data files in specified directories as if the files 
were in the current directory. Do not use this command when Uindous is 
running. 

The specified directories are called appended directories because, for the 
sake of opening data files, they can be found as if they uere appended to 
the current directory. 

Syntax 

APPEND [[driwe:lpath[;...11 C/Xi:0N!:0FF11[/PATH:0Nl/PATH:0FF1 [/El 
To display the list of appended directories, use the follouing syntax: 

APPEND 


Use the HELP command to bring up the full HELP utility. 


Figure B 


C:S>append /? 

Allous programs to open data files in specified directories as if they uere in 

the current directory. 

APPEND [[driue:lpath[;...11 [/X[:ON I :0FF11 [/PATH:0N I /PATH:0FF1 [/El 

APPEND ; 

[drive:Ipath Specifies a drive and directory to append. 

/X:ON Applies appended directories to file searches and 

application execution. 

/X:OFF Applies appended directories only to requests to open files. 

/X:OFF is the default setting. 

/PATH:ON Applies appended directories to file requests that already 
specify a path. /PATH:ON is the default setting. 

/PATH:0FF Turns off the effect of /PATH:ON. 

/E Stores a copy of the appended directory list in an environment 

variable named APPEND. /E may be used only the first time 
you use APPEND after starting your system. 

Type APPEND : to clear the appended directory list. 

Type APPEND uithout parameters to display the appended directory list. 

C:s> 


Use FASTHELP to view the basic information about a command. 
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